Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Movies

SetMovieSelection

The SetMovieSelection function sets a movie's current selection.

pascal void SetMovieSelection (Movie theMovie, 
                               TimeValue selectionTime, 
                               TimeValue selectionDuration);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

selectionTime

Contains a time value specifying the starting point of the current selection.

selectionDuration

Contains a time value that specifies the duration of the current selection.

DESCRIPTION

If you set the selectionDuration parameter to a value greater than the movie's duration, SetMovieSelection automatically adjusts the duration of the selection to correspond to the difference between the value specified in the selectionTime parameter and the end of the movie.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidTime	-2015	This time value is invalid

SEE ALSO

You can use the GetMovieSelection function, described in the next section, to obtain information about a movie's current selection.